cl ‘ 
Enter file name: 


 netram.dac 
WGOTKU/EFESBX/3799/Hollister, CA/S7@112/18242 
fW6TKU//Arroayo Grande CA/Monday 12-Jan-87 at 7:30 FM 


Notice to all users of the W6AMT digipeater system 
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The WOAMNT digipeater system is starting a test of "NET/ROM", which is a new 
firmware package for the TNC-2 which supports state-of-the-art networking 


Capabilities (commonly referred to in packet radio circles as "layer 3" and 
"Layer 4"), 


NET/ROM was installed at the W6AMT~-2 and W6AMT-3 sites-on January 11, i987. 
We hope to install the new firmware at W6AMT-@, W6AMT~1, and WSAMT—4 during 
the next couple of weeks. {Installation at W6AMT-7 will have to wait until 
spring, due to inaccessibility of the site.) 


The following information about NET/ROM is provided in order to enable users 
of the W6AMT system to participate in the test by utilizing the new 
Capabilities. Participating users should keep in mind that NET/ROM is still 
in a highly experimental stage. Flease report problems by leaving a message 
for WASDED an the W6IKXU Multibox. 


lisers who do not with to participate in the NET/ROM test may continue to use 
the W6AMT digipeater system in the usual fashion, since the new firmware 
Supports ordinary AX.25 digipeating. 


Civerview of NET/ROM 
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Introduction 
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NET/ROM is a firmware replacement which transforms a standard TAPR TNC-2 Cor 
“clone”") into a state-of-the-art network node controller. It 26 intended for 
use primarily on hilitops and other wide-coverage digipeater sites. Ito is snot 
appropriate for end-user or mailbox stations. 


A NET/ROM node provides the normal functions of an ordinary AX.25 digipeater, 
plus a set of sophisticated higher-level networking capabilities. A user may 
connect to a nearby NET/ROM node; display a list of other known network nodes; 
establish a transport-level circuit to a distant node; and connect to another 
end-user or mailbox in the vicinity of the distant node. Compared with 
conventional AX.25 multi-hop digipeating, NET/ROM‘’s true store-and-foarward 
packet switching technology can provide an order-of-magnitude improvement in 
throughput, especially over long paths. Routing from the local node to the 
distant node is handled automatically, and even includes alternate routing to 
circumvent network outages. 


NET/ROM supports cross-frequency and cross-band networking without the need 
for exatic multi-port digipeater hardware. A dual-channel node, for example, 
is implemented simply by installing NET/ROM in a pair of standard TNC-2Ss arc 
connecting them together with an RS@32 cable. A three- or four-channel nade 
can be created by connecting multiple TNC-2s together, using a simple 


diode-matrix coupler. 


NET/ROM was developed by Ron Raikes (WASDED) and Mike Buseh (WSIXU) of 
Sattware 28080, Inc. 
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BBS/MAILBOX COMMAND SET: — 
So ne lit 


This is a brief listing of the user commands available:- 


G) ie | 
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For 


Abort. 
Bye 
Conference 
DOS 
Facilities 
Gateway 
Help 
Info 
Jheard 
ie 
List 
Make 
Name 
PostCode 
homeBBS 
Options 
Servers 
Program 
Read 
Send 
Talk 
Upload 
Verbose 
What 


— 


White Pages- 


Expert 
Yapp 
Delete 
T.e.%.t 
Connect 
Ssh. Xx) 
Wildcard 


detailed help on each command, 


Abort listing or ascii file transfer. 

Log off (disconnect). 

Access to conference. 

Access to BBS-DOS, or to download a file. 

Access to Server mode. 

Access to other Network access node 7VALLY:GiDIL} 
Help. 
Information about the system. 

List of the last few connected stations. 
Kill messages. 

List messages. 

Copy a message to a file. 

Change your name. 

Change your PostCode. 

Change your HomeBBsS. 
Select/change user options. 

Show which servers are available. 
Run (show) certain DOS-programs. 
Read messages. 

Send messages. 

Talk to SysOp. 

Upload a file to the mailbox. 
Verbose read of messages (like R, 
Which files are available. 

Type "WP Callsign" to interrogate White Pages database. 
Change between Normal and Expert. 

Transfer binary files with Yapp transfer protocol. 
Delete a file. 

To send a text to another station connected to the BBS. 
To connect another station connected to the BBS. 
Display system status. 

Many possibilities, like @,7,#,=,¥% 


but with full headers). 


type H ECcommand] when logged onto GB7BBS 


aor refer to the listing below:- 


Enter file mame: 

netram. dac 

WOIXU/KEGRX/3S799/Hollister, CA/B701L13S/1024z 
AWOIXU//Arraya Grande CA/Monday 12-Jan-87 at 7:30 FM 


Notice to all Users af the W6AMT cdigipeater system 
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The W6AMT digipeater system is starting a test of "NET/ROM", which is a new - 
firmware package for the TNC-2 which supports state-of-the-art networking 
capabilities (cammonly referred to in packet radio circles as "layer 3" and 
"Layer 4"), 


NET/ROM was ‘installed at the W6AMT-2 and W6AMT~3 sites on January 11, 1987. 
We hope to install the new firmware at W6AMT-@, W6AMT-1, and W6AMT-4 during 
the next couple of weeks. (Installation at W6AMT<7 will have to wait until 
spring, due to inaccessibility of the site.) 


The following information about NET/ROM is provided in order to enable users 
of the WO6AMT system to participate in the test by utilizing the new 
capabilities. Participating users should keep in mind that NET/ROM is still 
in a highly experimental stage. Flease report problems by leaving a message 
for WASDED an the W6IXU Multibox. 


isers who da not with to participate in the NET/ROM test may continue to use 
the WSAMT digipeater system in the usual fashion, since the new firmware 
supparts ardinary AX.25 digipeating,. 


Overview of NET/ROM 
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NET/ROM is a firmware replacement which transforms a standard TAPR TNC-2 Car 
"clone") into a state-of-the-art network node controller. It is intended for 
use primarily on hilitops and other wide-coverage digipeater sites. It is not 
appropriate for end-user or mailbox stations. 


A NET/ROM node provides the normal functions of an ordinary AX.25 digipeater, 
plus a set of sophisticated higher-level networking capabilities. A user may 
connect to a nearby NET/ROM node; display a list of ather known network nodes; 
establish a transport-level circuit to a distant node; and connect to another 
end-user ar mailbox in the vicinity of the distant node. Compared with 
conventional AX.25 multi-hop digipeating, NET/ROM’s true store-and-forward 
packet switching technology can provide an order-of-magnitude improvement in 
throughput, especially over long paths. Routing from the local node to the 
distant node is handled automatically, and even includes alternate routing to 
circumvent network outages. 


NET/ROM supports crass-frequency and cross-band networking without the need 
for exotic multi-port digipeater hardware. A dual-channel mode, for example, 
is implemented simply by installing NET/ROM in a pair of standard TNC-2s and 
connecting them together with an RS2SS2 cable. A three- or four-channel node 
can be created by connecting multiple TNC-2s together, using a simple 
diode-matrix coupler. 


NET/ROM was developed by Ron Raikes (WASDED) and Mike Busch (WSIKU) of 
Software 2808, Inc. 
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Runs on ordinary TNC-2 hardware 


NET/ROM is unique because it provides state-of-the-art networking capabilities 
without the need for special hardware. NET/ROM runs on a standard TAFR TNC-2 
terminal node controller, or oan any of the commercially~available TNC-2 
"clones". WNET/ROM is distributed in the form of a 27C256 EFROM which simply 
plugs into the ROM socket of the TNC-2 in place of the standard TAPR firmware 
ROM. 


Store-and-forward packet switching 


Instead of multi-hop digipeating, NET/ROM provides true store-and-forward 
packet switching. The result is significant improvement in throughput and 
reliability. On long paths (three or more digipeaters), dramatic improvements 
are possible. For instance, the calculated speed improvement for the Los 
Angeles/San Francisco route (four digipeaters) assuming typical 12@@-baud VHF 
network conditions is about 8@an! 


Two-levels of error and flow control 


NET/ROM uses the standard AX.25v2 packet radio protocal for links between 
neighboring nodes, as well as for links from each node to its local users, 
Normal AX.25v2 error handling is used to assure error-free transmission, and 
normal AX.25v2 flow control is used to manage network congestion. 


I 

to provide end-to-end error and flow control for each virtual circuit. 
End-to-end error control protects against lost, duplicate, or out-of-sequence 
frames resulting from node failures and dynamic routing changes. End-to-end 
flow control protects the network against disproportionate loading by any ane 
Sarr cuits 


Multi-channel capability without special hardware 


NET/ROM supports multi-frequency operation without the need far exotic 
muilti~-port digipeater hardware. A dual-channel node, for example, consists 
simply of a pair of standard TNC-2s (with NET/ROM in each) connected tagether 
with a simple RS232 cable. Configuring a NET/ROM node for three or four 
channels is almost as easy: a TNC-2 is used for each frequency, and the 
multiple TNCs are interconnected via their RS232 ports using a simple 
diode-matrix coupler. 


Automatic adaptive routing 


NET/ROM automatically takes care af the routing of traffic between ane node 
and another. A user needs to specify just the desired destination, not the 
route. Each node keeps track of the other nodes in the network and the 
various possible paths that may be used to reach them. If a node ar path 
becomes unusable due to equipment failure or poor propagation, NET/ROM 
automatically switches to an alternate route (if available) to circumvent the 
outage. Conversely, when a new node is placed on-line, other nodes 
automatically incorporate the new node into the network routing structure. 
Such routing changes are handled dynamically, without disrupting user 
cannections in progress. 


Local, remote, and automatic routing updates 


NET/ROM supports three methods af updating its routing informations lacal, 


remote, and automatic. Initial routing information is entered manually by an 
on-site operator using a local terminal. Routing changes may be made remotely 
by a contreal operator over an ordinary packet radio connection--a randomized 


verification algorithm effectively prevents changes by unauthorized operators. 
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Runs an ardinary TNC=2 hardware 


NET/ROM is unique because it provides state-of<-the-art networking capabilities 
without the need for special hardware. NET/ROM runs on a standard TAPR TNC-2 
terminal node controller, or on any of the commercially~available TNC-2 
"clones". NET/ROM is distributed in the form of a 270256 EFROM which simply 


plugs into the ROM sacket of the TNC-2 in place of the standard TAPR firmware 
ROM. 


Store-and-farward packet switching 


Instead of multi-hop digipeating, NET/ROM provides true store-and-forward 
packet switching. The result is significant improvement in throughput and 
reliability. On long paths (three or more digipeaters), dramatic improvements 
are possible. For instance, the calculated speed improvement for the Los 
Angeles/San Francisca route (four digipeaters) assuming typical 120@-baud VHF 
network conditions is about 8@a%! 


Two-levels of error and flow control 


NET/ROM uses the standard AX.25v2 packet radio protocol for links between 
neighboring nodes, as well as for links from each node to its local users. 
Normal AX.25v2 error handling is used to assure error-free transmission, and 
normal AX.25ve flow contral is used to manage network congestion. 


I 

to provide end-ta-end error and flow control for each virtual circuit. 
End-to-end error control protects against lost, duplicate, or out-of-sequence 
frames resulting from node failures and dynamic routing changes. End-ta-end 


flow control protects the network against disproportionate loading by any one 
Garcuit. 


Multi-channel capability without special hardware 


NET/ROM supports multi-frequency operation without the need for exotic 
multi-port digipeater hardware. A dual-channel nade, for example, consists 
simply of a pair of standard TNC-2s (with NET/ROM in each) connected together 
with a simple RS232 cable. Configuring a NET/ROM node for three or four 
channels is almost as easy: a TNC-2 is used for each frequency, and the 
multiple TNCs are interconnected via their RS232 ports using a simple 
diode-matrix coupler. 


Automatic adaptive rauting 


NET/ROM automatically takes care of the routing of traffic between one node 
and another. A user needs to specify just the desired destination, not the 
route, Each node keeps track of the other nodes in the network and the 
Various possible paths that may be used to reach them. If a node or path 
becames unusable due toa equipment failure or poor propagation, NET/ROM 
automatically switches to an alternate route (if available) to circumvent the 
outage. Conversely, when a new node is placed on-line, other nodes 
automatically incorporate the new node into the network routing structure. 
Such routing changes are handled dynamically, without disrupting user 
cannections in progress. 


Lacal, remote, and automatic routing updates 


NET/ROM supports three methods af updating its routing informations lacal, 
remote, and automatic. Initial routing information is entered manually by an 


on-site operator using a local terminal. Routing changes may be made remotely — 
by a contreal operator over an ordinary packet radio connection--a randomized 
verification algorithm effectively prevents changes by unauthorized operators. 
In addition, NET/ROM nodes broadcast routing information to each other on an 
hourly basis, thereby enabling the network to incorporate new nodes and ta 
bypass outages in real-time without manual intervention. 


Very easy to use 


Despite its internal saphistication and advanced networking capabilities, 
NET/ROM is exceptionally easy ta use. There are anily two commands that a user 
needs to learn: NODES to obtain a list of other NET/ROM nodes, and CONNECT ta 
establish crosslinks to other nodes or downlinks to other user stations. 


Compatible with existing digipeaters 


Each NET/ROM node also supports the functions of an ardinary AX.25 digipeater. 
Users need not make use of the high-level networking functions of NET/ROM 
unless they want toa. Digipeater owners can upgrade their sites toa NET/ROM 
nodes without disrupting users. Multi-channel NET/ROM nodes provide 
multi-port digipeating as well. 


A Usage Example 
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You are KAGPRE ("Packet Radio Enthusiast") located in San Diego, and you want 
to access the WARLI bulletin board system in Santa Cruz (near San Francisco). 
From past experience, you know that a digipeated AX.25 connection requires 
four digipeaters and is practically unusable. The local W6AMT-4 digipeater on 
1435.@1 was recently upgraded to a NET/ROM nade, however, so this time you 
decide to try using the high-tech methad. 


First, you establish an uplink to your local node, using the noarmal cannect 
command provided by your TNC: 


cmd: CONNECT W6aMT—4 
*** CONNECTED to W6AMT-4 


Next, you ask the local node for a list of other NET/ROM nodes for which it 
has routing information, using the NODES cammand: 


NODES 
W6AMT-43 Nocdess 
WSAMT~3% W6AMT<—2 W6AMT=1 WeAMT WeAMT-7 AASTN—1 


You know that W6AMT-@ serves the San Francisco area (it was always the last 
digipeater you used to reach WORLI via AX.25), sa you ask your local NET/ROM 
node to connect you to W6AMT: 


CONNECT W6AMT 
W6AMT-43 Connected to W6AMT 


You are now talking to the San Francisco node, and you could issue another 
NODES command to see a list of other nodes that it knows how to reach. In 
this case, however, you simply want a connection to the W@RLI BRS, so you ask 
fot | peas 


CONNECT W@RL 

W6AMT? Connected to WaRLI 

Hello Fred, welcome to WORLI BES at W322 
KAGPRE-15 de WORLI > 

etc. 


Note that the downlink from W6AMT to WO@RLIT has been made using your callsign 
(KASPRE), but with the SSID suffix changed from -@ to ~15. (More about this 
later. ) 


Note that the downlink from W6AMT to WORLI has been made using your callgsign 
(KRASPRE), but with the SSID suffix changed from -@ to ~15, (Mare about this 
later.) 


At the conclusion of your session with WORLI BES, you simply disconnect your 
TNC as usual: 


ot { 

emeads DISe 

**#* DISCONNECTED 
cmels 


When you disconnect, your local mode (W6AMT=4) automatically disconnects your 
Circuit to WoAMT, and the W6AMT nade automatically disconnects your downlink 
ta W@RLI. 


Theary of Qperatioan 
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Following are definitions of some terms that are used in describing the 
Operation of NET/ROM. 


User -~ Any amateur packet radio station using AX.25 protocol. In the context 
af this deacument, a BRS or other automated server is considered a "user". 


Digipeater -- A station capable of digitally repeating AX.25 frames as 
specified in the AX.25 protocol specification. Generally, refers to an 
unattended, wide-coverage digital repeater, oaften located on a hilltop. 


Node -~ A packet radio station utilizing TNC-2 hardware executing NET/ROM 
firmware. Generally, refers to an unattended, wide-coverage station, often 
located an a hilltop. 


Dual-Channel Node -- A pair of NET/ROM nodes operating on two different 
frequencies, and coupled together by means of an RS@32 cable. 


Multi-Channel Node --JThree or more NET/ROM nodes operating on different 
frequencies, and interconnected via their RS232 ports using a diode-matrix 
coupler. 


Link ~~ An AX.25 connection involving a node at one or both ends. 
Node-to-node links always use AX.25v2 protocol. User-to-node links use 
AX.25v2 protocol if the user’s TNC supports it, otherwise AX.25vl. 


Uplink -- An AX.25 connection between a user and a node, initiated by the 
user. An uplink is usually a direct connection, but may be digipeated if 
necessary. 


Downlink -~- An AX.25 connection between a node and a user, initiated by the 
node. A downlink is usually a direct connection, but may be digipeated if 
necessary. A downlink is established by a node at the behest of a user (in 
respanse to a CONNECT command). 


Crosslink -~ An AX.25 connection between two adjacent nodes. A crosslink is 
usually a direct connection, but may be digipeated if necessary. A crosslink 
between two nodes is initiated by one of the nodes when first establishing a 
circuit which traverses the route seqment between the two nodes. One 
crosslink can carry any number of circuits, so it is never necessary to have 
more than one crosslink between any pair of nodes. 


Circuit -- A transport-level connection between two nodes, established by one 

of the nodes at the behest of a user (Cin response to a CONNECT command). The — 
two nodes are not necessarily adjacent, and may be quite distant. The circuit 
is automatically routed through intermediate nades as necessary, and carried 
from node to node over crosslinks (which are initiated if not already 
established). 


Digipeating vs. Store-and—Forward 
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The AX.25 protocel was originally designed for point-to-point (non- 
digipeated) connections. AX.25 was subsequently extended. ta accomodate one 
digipeater, and later extended again toa allow up to eight digipeaters. 


As all experienced packet radio users know, however, AX.25 is practically 
unusable for communications on paths exceeding two or three “hops". The 
reason for this is that AX.25 digipeaters do not participate in error control. 
For an AX.25 packet to traverse a multi-hop path, it must not fall victim to a 
collision or other error during any of the hops; otherwise, it must be 
retransmitted by the originating station and start its journey all over again. 


The probability that an AX.25 packet can complete its journey successfully 
deteriorates rapidly as the number of hops increases. For example, it takes 
five hops (four digipeaters) toa get from Los Angeles to San Francisca. Tt the 
average reliability per hop is 90% (which may be optimistic in those congested 
areas), then the probability that a packet will traverse the five-hop path 
unscathed and be successfully acknowledged (which requires ten errar-free 
hops) is less than 35%. In other words, it will take an average of 2.9 tries 
to get the packet through successfully. Since the usual timeout threshhold 
for a five-hop path is 36 seconds, the average elapsed time to get the packet 
through will average about 77 seconds! (CThis assumes a 1@% error probability 
per hop, and the usual 128@—-baud timeout of 4*#(2*edigist+l) seconds. ] 


Using NET/ROM nodes instead of ordinary AX.25 digipeaters changes this 
situation dramatically for the better. When the Los Angeles user transmits a 
packet destined for San Francisco, it igs received by the local NET/ROM node 
serving Los Angeles. That node immediately passes the packet to its 
neighboring node to the north, and sends an acknowledgement back to the user. 
This process is repeated five times in all. Whenever a packet is lost due to 
collision oar other error, recovery is handled by just the two adjacent nodes 
involved. As a result, the average elapsed time to get a packet through 
decreases to less than 1@ seconds, about an 800% improvement in throughput. 
[Same assumptions as previous example.] For longer paths, the payoff is even 
more dramatic. 


Uplinks, Downlinks, and Crosslinks 
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Suppose you are a user with access to a lacal node, and you want to cantact 
another user station who is also within range of the same node. You can, of 
course, connect to the other station "the old way” by using the node as a 
digipeater. To take advantage of the store-and-forward capabilities of the 
node, however, you would use this two-step procedure: ¢1) cannect ta the node 
("uplink"); then, (2) issue a CONNECT command with the callsign of the other 
user station ("downlink"), 


All AX.25 frames include the callsigns of bath the originating station and the 
destination station. When you request a downlink, the node "adapts" your 
callsign as the originating station (rather than using its own callsign). 

This is necessary so that the destination station can properly identify you as 
the connecting user station, and is especially important when the destination 
is a mailbox, gateway, or other automated server. 


Well...not exactly! If the node truly did "adopt" your callsign, and if there 
also happened to be a direct path (however marginal) between your station and 
“the destination station, that station would then be “in range" of two stations 
using the same callsign. This can create serious confusion, 

AX. 25-pratocolwise ! 


All AX.25 frames include the callsigns of both the originating station and the 
destination station. When you request a downlink, the nade "adopts" your 
callsign as the originating station (rather than using its own callsign). 

This iS necessary so that the destination station can properly identify you as 
the connecting user station, and is especially important when the destination 
iS Aa mailbox, gateway, or other automated server, 


Well...mot exactly! If the node truly did “adopt” your calleign, and if there 
also happened to be a direct path (however marginal) between your station and 
the destination station, that station would then be “in range" of two stations 
using the same callsign. This can create serious CONFUSION, 
AX. 25—-pratocealwi se! 


Ta avoid this problem, the doawnlinking node "adopts" your basic callsign, but 
changes the SSID (the "—N" Callsign suffix) from N to 15-N. For example, if 
your callsign is KéAAA, the downlink uses K6AAA-153 if your callsign is’ 
WSARC—2, the dawnlink uses WSARC<13; and so forth. 


Now, Suppase you want to contact a user station that can‘t capy your local 
node, but is in range of another node that serves his area. Once again, you 
could use "old-style" multi-hop digipeating to reach him (since every node is 
also a digipeater). To utilize the full store-and~forward capability of the 
nodes, hawever, you would use a three-step procedure: (1) connect to your 
local node; then, (2) issue a CONNECT command with the callsign of the distant 


node; finally, (3) issue a CONNECT command with the callsign of the other user 
station. 


When you perform step (2) of this procedure, you are asking your local node ta 
create a "circuit" for you between your local node and the distant node. I¢ 
the two nodes are sufficiently far apart, the circuit may have to pass through 
several intermediate nodes. In any case, the routing is performed 
automatically by the node. Your circuit is carried by a series of AX, 25 
"crasslinks" between pairs of adjacent nodes. In all likelihood, the 
Necessary crosslinks are already established when you issue your CONNECT 
Command (one crosslink can carry many circuits); if not, then the necessary 
crosslinks are set up. All of this crosslinking stuff happens automatically 
and transparently-~you needn't worry about it, but it’s interesting to know 
what ’s going on up there on the hilltops! 


Error and Flow Control 
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NET/ROM uses the standard AX.25v2 packet radio proatecel for crosslinks between 
neighboring nodes, as well as for links from each node to its local users. 
Normal AX.25v2 error handling is used to assure error-free transmission, and 
normal AX.25v2 flow control is used to control network congestion. 


In addition, NET/ROM incorporates a transport~—level "sliding window prataceal" 
ta provide end-to-end error and flow control for each virtual circuit. 
End-to-end error control is necessary to protect against lost, duplicate, or 
aut-of-sequence frames resulting from node failures and dynamic routing 
changes. End-to-end flow control is necessary to protect the network against 
disproportionate loading by any one circuit. 


The transport-level protocol used by NET/ROM is similar in cancept to the 
familiar AX.25, but is somewhat more sophisticated. For example, it can 
accept out-of-sequence frames and re-gequence them internally. It can also 
selectively request a repeat of a missing frame without requiring 
retransmission of all succeeding frames. 


Network Routing 
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When you ask one node for a circuit to a distant node, your CONNECT command 
specifies the callsign of the destination node, but the routing is handled 
automatically by NET/ROM. Automatic routing is handled by the Routing — 
Manager, and is cantrolled by its routing table. 


The routing table within a node is a list of all the destination nodes "known" 
to this node. You can ask to see this list by using a parameterless NODES 
command. The routing table can keep track of a relatively larqe number of 
other nodes. 


“Tf you want to connect to an especially distant node, it is possible that your 
local node doesn’t know of it (i.e@., it is not listed in the local NODES 
display). In this case, you can use CONNECT to obtain a circuit to a known 
node nearer the desired destination, and then issue another NODES command to 
get a list of the nodes known to that node. This process can be repeated if 
“necessary. 


For each known node, the rauting table contains one or more known routes to 
that node. In this case, a "route" is simply a crosslink path to an adjacent 
node that is closer to the ultimate destination. The crosslink path usually 
consists of just the callsign of the adjacent node, but may also include one 
or more Cugh!) digipeaters if necessary. 


Observe that the routing table does not contain the entire route to each known 
destination (this is unnecessary, and would require too much memory), but just 
a list of adjacent nodes that are reasonable choices for a next hop enroute 
to the destination. You can ask to see this list by using a NODES command 
specifying the callsign of the destination. 


If a node or path becomes unusable due to equipment failure or poor 
propagation, the Routing Manager automatically switches to an alternate route 
(if available) to circumvent the outage. Such routing changes are handled 
dynamically, usually without disrupting circuits in progress. 


Routing Table Updates 
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Since each node keeps track of many other nodes and the available routes to 
those nodes, it is important that this routing information be kept up-to-date 
to reflect the current state of the network. NET/ROM supports three methods 
of updating its reuting tables: local, remote, and automatic. 


When a node is first placed on-line, an initial set of routing information is 
entered manually by a control operator using a local terminal connected to the 
RS232 host port. Routing changes may be made remotely by a cantrol operatar 
over an ordinary packet radio connection. A randomized verification algorithm 
effectively prevents changes by unauthorized operators. 


To enable the network to incorporate new nodes and to bypass extended outages 
without the need for control operator intervention, NET/ROM also provides a 
mechanism for automatic update of routing information on a distributed basis. 
About once per hour, each node automatically broadcasts a list of all other 
nodes which it knows how to reach. (This broadcast takes the form of an AX. 25 
UI-frame addressed to "NODES" with PID=’CF’.) When this broadcast is received 
by neighboring nodes, they automatically make any necessary additions to their 
routing tables, and incorporate them into their own hourly broadcasts. Thus y 
whenever a new node is placed on-line, knowledge of the new node automatically 
propagates throughout the network within a few hours. 


Station Identification 
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In order to conform with FCC regulations concerning station identification, 
each NET/ROM node identifies itself every 9 minutes and 39 seconds. The 
station identification is carried by an AX.25 Ule-frame addressed to "ID" and 
cantaining the text "Network node". 


Digipeating 


Of course, each node also supports the functions of an ordinary AX.25 
digipeater. Users need not make use of the high-level networking functions of 


Digipeating 
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Of course, each node also supports the functions of an ardinary AX, 25 
digipeater. Users need not make use of the high-level networking functions of. 
NET/ROM unless they want to. Digipeater owners can upgrade their sites to 
NET/ROM nodes without notifying the user population=-the users won't notice 
any change unless they happen toa monitor a station-id broadcast or try to 
connect ta the node (expecting a "busy" message). 


Furthermore, @ach multi-channel node is also a multi-port digipeater. Each 
channel is assigned a different callsign. Often, the same basic callsign will 
be used, but with different SSID suffixes for each frequency. (For example, 
N6éNET—1 on 145 MHz and NO&NET=-11 on 220 MHz. ) Cross-frequency digipeating is 
requested simply by including both callgigns as digipeaters (@.g., "C W6ZZZ 
Via N6NET=-1,NONET—-11,..."). 


Users of distant mailboxes, gateways, and other automated servers have two 
Options: they can connect "the old way” (via multi-hop AX.25) or "the new way” 
(via the uplink=crosslink-downlink procedure). Hoth methods will work with 
all existing BRSs. 


Auta~forwarding mailbox systems will have to use "the old way" until such time 


as their auto-forwarding algorithms have been updated to take advantage of 
NET/ROM, 


Dual— and Multi-Channel Operation 
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To realize the full potential af NET/ROM’s high-level networking capabilities, 
it is an excellent idea to minimize interference between local 
Cuplink/downlink) and long-haul (crosslink) traffic. Gne goad way ta 
accomplish this is to reserve one radio frequency exclusively for inter-node 
traffic, to provide end-user access to the nodes on one or more separate 
frequencies, and to discourage (ideally, to prevent) end-users from using the 
inter-node "backbone" frequency. This approach requires network nodes that 
Can access two or more frequencies. 


NET/ROM supports such multi-channel operation without the need for exotic 
multi-port digipeater hardware. A dual-channel node, for example, consists 
simply of a pair of standard TNC-2@s (with NET/ROM in each) connected together 
with a simple RS2S2 cable. Each TNC takes responsibility for handling traffic 
On a single frequency; cross-frequency traffic is passed over the cable 
between TNCs at relatively high speed. 


Configuring a multi-channel NET/ROM node for three or more channels is almost 
aS @asy as dual-channel operation. A TNC-2 with NET/ROM installed is used for 
each frequency. Once again, the TNCs are interconnected via their RS232 
ports, Intercannecting three or more TNCs in this fashion requires nothing 
mare @laborate than same isolation diodes. 


Cammands 
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There are just two user commands: CONNECT and NODES. The entire command verb 
("CONNECT") or just a fragment ("CONN" or "CO" or "C") is allowed. Any 
command parameters must be separated from the verb and each other by one or 
more spaces. The maximum command length is 8@ characters (anything more is 
ignored). Commands must end with a carriage-return. 


< 


CONNECT Command 
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The CONNECT command is used to request a circuit to another node, a dawnlink 
to another user, or a connection to the node's host terminal. 


To request a circuit to another node, the command is: 


CONNECT nodecall iaetes : a A a 


where "“nodecall" must be the callsign of another node that is "known" to this 
node. Use the NODES cammand to abtain a list of all known node callsigns. 


To request a downlink ta another user, the command is: 

CONNECT usercall CCVIA] digicall,...,digicall] 
where "“usercall" is the callsign of the user station, and "digicall" is the 
callsign of a digipeater. If digipeaters are used, the use of "VIA" is 
optional ("VI" or "V" are also acceptable). Callsign parameters may be 
separated by either spaces or commas. 
To request a connection to the node’s host terminal, the command is: 

CONNECT 
with no parameters. 
In all cases, a successful connection is announced by the message "Connected 
ta (callsign)". "Failure with (callsign)" indicates that the specified node 
or user did not respond after a number of attempts. "Busy from (callsign) " 
indicates that the node or user responded but refused the connection request. 
Other possible error messages are "User table full", "Circuit table full", 
"Link table full", and "Host table full". These messages indicate a lack of 
resources in the node-~the user should disconnect and try again later. 
An in-process CONNECT command is immediately aborted if another command or a 


blank line is entered before the requested connection is established. 


NODES Command 
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The NODES command is used to display the node's routing table. 
To display a list of other nodes known to this node, the command is simply: 
NODES 


To display specific routing information for a particular node, the command is: 


MODES nodecall 


where "nodecall" must be the callsign of a known node. This command displays 
the transport-level timeout period (in seconds), plus a list of routes for the 
specified destination. For each route, the following information is 


displayed: port number (@=HDLC, 1l=RS232), callsign of the adjacent node, and 
any necessary digipeaters (maximum of three). 


Command Interpreter Messages 


The following messages may be displayed by the command interpreters 


Connected toa (callsign) 
Busy from (callsign) 
Failure with (callsign) 
Invalid command 

Invalid callsign 
Circuit table full 

Link table full 

Host table full 

User table full 


to another user, or a cannection to the node's host terminal, 
To request a circuit to another node, the command ig: 
CONNECT noadecall 


where "nodecall" must be the callsign of another node that is "known" to this 
nade. Use the NODES cammand to abtain a list of all known node callsigns. 


Ta request a downlink ta another user, the command igs: 
CONNECT usercall CLVIA] digicall,...,digicalld 


where "usercall" is the callsign of the user station, and "digicall” is the 
callsign of a digipeater. If digipeaters are used, the use of "VIA" is 
aptional ("VI" or "V" are also acceptable). Callsign parameters. may be 
separated by either spaces or commas. 


Ta request a connection to the node’s host terminal, the command ig: 


CONNECT 
with no parameters. 


In all cases, a successful connection is announced by the message "Connected 
to (callsign)". "Failure with (callsign)" indicates that the specified node 
or user did not respand after a number of attempts. "Busy from (callsign) ” 

indicates that the node or user responded but refused the connection request. 


Other possible error messages are "User table full", "Circuit table full", 
“Link table full", and "Host table full". These messages indicate a lack of 
resources in the node--the user should disconnect and try again later. 


An in-process CONNECT command is immediately aborted if another command or a 
blank line is entered before the requested connection is established. 


NODES Command 
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The NODES cammand is used to display the node’s routing table. 


To display a list of other nades known to this node, the command is simply: 


NODES 


To display specific routing information for a particular node, the command iss 


NODES nodecall 


where "“nodecall" must be the callsign of a known node. This command displays 
the transport-level timeout period (in seconds), plus a list of routes for the 
specified destination. Far each raute, the following information is 
displayed: port number (@=HDLC, 1L=RS232), callsign of the adjacent node, and. 
any necessary diqipeaters (maximum of three). 


Command Interpreter Messages 


The following messages may be displayed by the cammand interpreters 


Connected ta (callsign) 
Busy fram (callsiqn) 
Failure with (callsign) 
Invalid cammand 

Invalid calisiaqn 
Circuit table full 

Link table full 

Host table full 

User table full 
“Routing table full 


Limitations 


The following limits apply to the "Alpha-Test" version of NET/ROM, and will 
probably be increased (possibly doubled) in the final release versian: 


* Maximum number of links per node: 28 


* Maximum number of circuits per mode: 16 


~r 


* Maximum number af other known nodes: 32 
* Maximum number of command interpreter tasks: 8 


On 87@716 at 2147 There are 98 msgs, Last msq is #20035. 
Mai tices Bo-sbye,- 4 Help, T -— Talk to Barry, 1 ~— iIntormation 
J - Calls heard, X - Short/Long Menu 
Messages: Lo - List, R - Read, S ~ Send, FE - Fill 
Files: W- Files U ~- Upload to disk D —- Dawnload (or display file) 


BBS/MATLBOX COMMAND SET: 


This is a brief listing of the user commands avallable:-— 


G@ 


MN eee CON aa ee 2 oS Se ee 
Mm 


cece 


For 


Abort 
Bye 


Conference 


DOS 


Facilities 


Gateway 
Help 
Info 
Jheard 
Kill 

kb PS t 
Make 
Name 
PostCode 
homeBBS 
Options 
Servers 
Program 
Read 
Send 
Talk 
Upload 
Verbose 
What 


White Pages- 


Expert 
Yapp 
Delete 
te,» Me 
Connect 
Info 
Wildcard 


detailed help on each command, 


Abort Listing or ascii file transfer. 

Log off (disconnect). 

Access to conference. 

Access to BBS-DOS, or to download a file. 
Access to Server mode. 

Access to other Network access node 7VALLY:G1IDIL} 
Help. 

Information about the system. 

list of the last few connected stations. 
Kill messages. 

List messages. 

Copy a message to a file. 

Change your name. 

Change your PostCode. 

Change your HomeBBsS. 

Select/change user options. 


“Show which servers are available. 


Run (show) certain DOS-programs. 
Read messages. 

Send messages. 

Talk to SysQp. 

Upload a file to the mailbox. 
Verbose read of messages (like R, 
Which files are available. 

Type "WP Callsign" to interrogate White Pages database. 
Change between Normal and Expert. 

Transfer binary files with Yapp transfer protocol. 
Delete a file. 

To send a text ta another station connected to the BBS. 
To connect another station connected to the BBS. 
Display system status. 

Many possibilities, like @©,7,#,=,%* 


but with full headers). 


type H Ecommand] when logged onto GB/BBS 


or refer to the listing below:- 
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tneset Version 1.00 DIM 
tnesets usage tneset Coptions] Cfiled 
where ootieans = 
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~b#  hbaucd rate PSGOO | 

~r#t oarity O=none,l=odd Seven C2] 


-st stop bits 1 or 2 ig 


“wi word length wor be9 
“Ul ae not anit pert 
me abort KISS mode 

rq quiet mode 

where file is name of optional command file, may reside on FATH 

default file is TNC.CFG 

vYalid METS commands in command file are: 

$DELGY m (n is delay in seconds) 

SAL SS faborts kiss mode) 

*#DAYTIME (sends daytime command to tne) 

$2ROMET nm €O disables orompt cheching, I= turns it on? 


feetory “Yok ESC cancel 
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SHITCONY OFF 
AXS5L2V2 ON 
ACKFRICE ON 
ACKTIME 14 
ANSWRARA CN 
ASYRXOVR 
ASYFRERR © 
ASPECT 2 
ASYQOVER © 
AUTOLE CN 
AWLEN gj 
AXDELAY © 
AXHANG =o 
BEACON EVERY oO 
BEFAILED © 
BRSMSGS OFF 
BEONDEL GN 
BLP OFF 
BTEXT 
BUDLIST OFF 
Link state ie: DISCONNECTED 
CBRELL OFF 
CONFERM OFF 
CHECK i2 
CHECEV1 OFF 
CLEADI s) 
CMDTIME i 
CMSG OFF 
CMSGDISC OFF 
CPACTIME OFF 
cr ON 
CTEXT 
CANLINE #18 
COMMAND $073 
CALSET oO 
CANFAC #19 
CONCE CN 
CONMODE CONVERSE 
CONSTAMFE OFF 
DAYUSA ON 
DEGDTIME 3 
DEFLTDLC 254 
DELETE OFF 
DWALT a3 
DIGIPEST ON 
DIGISENT © 
ECHO ON 
ESCAPE OFF 
FLOW ON 
FAXMODE 3 
FAXEOFP ON 
FAXNEG OFF 
FAXREY OFF 
FIRMENR CN 
FRACK % 
FULLDUF OFF 
HEADERLN OFF 
HEALLED OFF 
HID OFF 
HOVRERR © 
HUNDRERR © 
KISS OFF 
LCcoK ON 
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BEITCONY OFF 
AXS5L2V2 CN 
ACKER IGOR ON 
ACK TIME 14 
ANSWRARA ON 
ASYRXOVE © 
ASYFRERER 
ASPECT ie 
ASYQOUVER © 
AUTOLE ON 
AWLIEN 3 
AXDELAY © 
AXHANG ©) 
REACON EVERY 0 
BRFATLED © 
BRESMSGS OFF 
BRONDEL ON 
BLP OFF: 
BTEXT 
BUDLIST OFF 
Link state iss 
CBELL OFF 
CONFERM OFF 
CHECK la 
CHECEV1 OFF 
CLEADT ia) 
CMDTIME 4 
CMSG OFF 
CMSGDISC OFF 
CPACTIME OFF 
CR ON 
CTEXT 
CANLINE #18 
COMMAND 8035 
CALSET ci) 
CANF AC S19 
CONGE ON 
CONMODE CONVERSE 
CONSTAMFE OFF 
DAYUSSs CN 
DEADTIME 3S 
DEFLTDLC 254 
DELETE OFF 
DWATLT 33 
DIGIFEAT GN 
DIGISENT © 
ECHO CN 
ESCAPE OFF 
FLOW ON 
FAXMODE cS 
FAXEOFE ON 
FRARNEG CRF 
FAXREY GFF 
FILRMENE CIN 
FRACK 3 
FULLDUF OFF 
HEADERLN OFF 
HEALLED ~ OFF 
HID OFF 
HOVRERR © 
HUN DRERE ¢ 
KISS GFE 
LOOK ON 
BPaADD 22. 05E: 
LF IGNORE OFF 
LCALLS 
LCSTREAM GN 
MONITOR ON 
MALL ON 
MAILBOX OFF 
MATLLED ON 
MCON OFF 
MCOM OFF 
MFILTER $00 
MNONAX 2S OFF 
MRE T ON 
MS TAME GFF 
MYCALL NOCALLL 
MYAL TAS 
MYDLONUM © 
MAXFRAME 4 
NEWMODE OFF 
NOMODE OFF 
NUCK OFF 
NULE OFF 
NULLS O 
FAC LEN 128 
FARITY o 
FASS $16 
FASSALL CFF 
FACTIME AFTER 10 
RCVDFRMF © 
ROYDIFRA © 
RCVDREJ © 
RCVDRNR 0 
RCVDSABM 0 
RE TRY in 
REDISFLA B12 
RESPTIME © 
RXABORT 1 
RXBLOCK OFF 
BRXCOUNT © 
RXERRORS © 
RXLENERR © 
RXRESYNC © 
SITREENLN © 
SENDFPAC $02 
SENTFRMF © 
SENTIFRA © 
SENTREJ © 
SENTRNE = © 
SLOTS 3S 
START $11 
STOrP $13 
STREAMSW #87C 
STREAMCA OFF 
STREAMDB OFF 
TRELCW OFF 
TRIES ) 
TRACE OFF 
TXCOUNT © 
TXDELAY ”. 33 
TXDELAYC 2 
TXDIDDLE OM 
TKFLOW OFF 
TXGOVELW © 
TXTMG © 
TXUIF RAM CM 
UNF ROTO Ct 
USERS ie! 
XFLOW CON 
XMITOK CIN 
XOFF $13 
XON $11 
camel ¢ 
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20. Overview of CLX 4.05 user commands 
Only the upper case parts of the commands have tp be entered, the lower case part is 


optional: 


SHOW/CONFIGURATION/NODES is identical to SH/C/N. Arguments in [square 


brackets] denote optional characters. They may or may not be entered. Arguments in 
"<" and ">" are variables. For <call> you must specify a real callsign. CLX does not 
care if you use upper case letters or lower case. 


ANNOUNCE 

BYE 

CLEAR/ PROFILE 
CLEAR/QSL 
CONFERENCE 
DELETE 
DIRECTORY 

DX 

GREP 

QUIT 

READ 

REPLY 

SEND 

SET/ALARM 
SET/ALIVE 
SET/ANNOUNCE 
SET/ANSI 
SET/BEEP 
SET/CHARSET 
SET/DISTRO 
SET/DXDEDX 
SET/DX_ ANNOUNCE 
SET/EXIT 
SET/FILTER 
SET/HERE 
SET/HOME NODE 
SET/ LANGUAGE 
SET/ LOCATION 
SET/LOGIN ANNOUNCE 
SET/NAME 
SET/NOALARM 
SET/NOALIVE 
SET/NOANNOUNCE 
SET/NOANSI 
SET/NOBEEP 
SET/NODISTRO 
SET/NODXDEDX 
SET/NODX_ANNOUNCE 
SET/NOFILTER 
SET/NOHERE 


SET/NOLOGIN_ ANNOUNCE 


SET/NOTALKTIME 
SET/QTH 
SET/TALKTIME 
SHOW/ANNOUNCEMENTS 
SHOW/ BANDS 
SHOW/CBA 
SHOW/CHARSET 

SHOW/ CHARSETS 
SHOW/ CLUSTER 


Announcement to all locally connected users 
Terminate connection 

Delete user profile 

Delete QSL information 

Enter the conference named <name> 

Delete messages <nrl,..,nrxX> 

List last five messages 

Enter aDA spot 

Scan all bulletins for the string <pattern> 
Terminate connection 

Read message <nr> 

Reply to message <nr> 

Send a message to <call> at <nodecall> 

Set a warning alarm for a specific string 
Turn on the alive timer 

Turn on Announcements 

Turn on some colour attributes 

Turn on beep with DX und ANN 

Define character-filter 

Add the user <call> to the list <listname> 
Switch off "anternet” spots 

Turn on show dx-spots 

Define exit string for talk, send etc. 
Set freq. or mode filter number <nrl,. 
Set the here - flag 

Set home-node for messages 

Define preferred language 

Define location of your station 

Show user login and logout 

Enter your name 

Turn off the warning alarm 

Turn off the alive timer 

Turn off announcements 

Turn off colour attributes 

Turn off beep with DX and ANN 

Remove a user from the list <listname> 
Turn on "internet" spots 

Turn off show dx-spots 

Unset all filters or only number <nrl,. 
Set the nohere - flag 

Turn off user login and logout show 
Turn off the time in talks 

Enter your QTH (Name) 

Set a time flag for talk sessions 

Show last five announcements 

List all segments known for <mode> 
!Get callbook information for <call> 
Show character-set currently in use 
Show all available character-sets 

Show cluster configuration information 
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SHOW/ COMMANDS Show all udt-tables incl. info header 


SHOW/ CONFERENCE List all conferences going on 

SHOW/ CONFIGURATION Show users at node <call> 

SHOW/ CONTEST Show contests that fit a wildcard 

SHOW/ DISTRO Show members of the list <listname> 

SHOW/ DX Show spots from a certain date 

SHOW/DXCC Show DXCC Country of <call> 

SHOW/DXDEDX Show zones defined as "internet" spots 

SHOW/ DXFROM Show which last five callouts <call> has made 
SHOW/DXSTATISTIC Query which bands have had the most DX over three time periods 
SHOW/EXIT Show exit string 

SHOW/FILTER Show which filter is set 

SHOW/ FILTERS Show all defined filters 

SHOW/GRAYLINE Show grayline times for a given locator 

SHOW/ HEADING Show beam headings for a given locator 

SHOW/ LANGUAGE Show which language is set 

SHOW/ LANGUAGES Show all present languages 

SHOW/ LOG Show the last five logins/logouts of <call> 
SHOW/MANAGER Show DX calls for which <call> is manager 
SHOW/ PREFIX Show DxCC Country of scall> 

SHOW/ PROFILE Show private profile 

SHOW/QSL Show QSL information for <call> 

SHOW/STATION Show personal information of <call> 

SHOW/ SUN Calculate sunrise/sunset for <qthloc> 
SHOW/UPTIME Show the uptime of the node 

SHOW/USERS List of locally connected users 

SHOW/ VERSION Show CLX version 

SHOW/WCY Show recent WCY Propagation information from <date> 
SHOW/WWV Show recent WWV data from <date> 

TALK Switch to talk mode with <call> 

UPDATE/ PROFILE Modify/create login script 

UPDATE/QSL Enter QSL information 

WWV Input WWV data 

Commands marked with a ! are sysop configurable optional commands and may not be 
available. 


To find out differences between CLX and AK1A's PacketCluster software, use HELP 
PACKCLUS. 
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From: Chris & Bill Shell [mailto:n6bws@msn.com] 


Sent: Sunday, May 07, 2000 9:17 PM 
To: ‘Franta Bendl’; nbws@msn.com; ‘CLX’ 


Subject: RE: Definable Local Nodes List 


Franta, 

Thank you for your consideration of my proposal for the new capability. 
I'll be looking forward to your next release. 

73, Bill 

N6WS 

n6ws@msn.com 


From: —— owner-clx@lists.hes.iki.fi [mailto:owner-clx@lists.hes.iki.fi] On Behalf Of Franta Bendl 


Sent: Saturday, May 06, 2000 2:26 AM 
ile: n6ws@msn.com; CLX 


Subject: Re: Definable Local Nodes List 


Chris & Bill Shell wrote: 
Ben & Franta, 


I would like to propose a new capability for CLX. I call the new capability 
definable local nodes. It would allow passing of local announcements 
between specific contiguous nodes. Sysops could build a table, define an 
attribute in cluster_par, or list nodes in clx_par for forwarding of 
announcements when sent as a local announcements. 


nice idea! 


An example of where this would be used is in the close nodes here separated 
by ranges of mountains. Since there are five nodes locally serving a small 
geographic area and spanning a distance of only 60km, users would like to 
simply make an announcement for the five nodes. Use of ann/full which would 
cover all of California plus additional areas that are open to PC12 messages. 


I believe this could be accomplished by either generating multiple 

internodes PC12 announce broadcasts for each node, or by implementing a new 
PC## protocol message. It would seem that use of the existing PC12 message 
format would be more compatible with PacketCluster nodes allowing them to be 
defined as local. However, your higher numbered wcy broadcasts seem to pass 
through PacketCluster nodes unhindered, so you might choose to add a PC## 
message. 


i believe that using of multiple PC12 has advantage of working also with ak1a sw. unfortunaltely it's not 
true that ak1a pass the uknown PC through. as a rule it crashs and therefore clx doesn’t send own PCs to 
ak1a. 


Please tell me what you think of this idea. 


i realized it already and it will be active with the next release. i hope it help to reduce the number of 
ann/full! 
73, Bill 
N6WS 
n6ws(@msn.com 


73 de franta 
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users priority an the channel to avoid monopolizing the channel 
with the transfer. 


After you have established a connection using your favorite 
cammunications program proceed as follows: 


ig . CExit converse mode into the TNC’s command model. 

cmd: t [Go into transparent model 
CTAt this point exit you terminal program and return ta 
MS-DOS. 


If you are sending a files: 


Pr \ . 
Aspmodem sb test.bin 
ii t—-—-—> The file you wish to send. 
ttomeam eee > Talis pmodem to use Batch mod& 
Pane neinnne | Tele pmpdemn ta. send a file 


If you are receiving a file: 
Aspmoadeam rhg 


: 


Litho > Talis omocden to use “G° mode for Facket 
ptr eee > Tells pmodem ta use Hatch made 


fmm > Telig pmodem to receive one aor more files 


Another example, send all .DOC files and two e@xecutable files: 
Acomadem sb *#.doc test.com testi.@xe 


While not necessary it is always preferable to use FMODEM in the 
batch mode even when transferring anly one file. The correct file 
Size will be recorded in the directory only if the file was 
transferred using batch mode, in non-batch mode the tile size 
will be rounded up to the next 128 byte boundary. This is not a 
problem with MOST files, but there are some programs which will 
malfunction if their data files are larger than expected. 


This program has been tested by five stations in the Los Angeles 
area over the last couple of months and several megabytes of data 


circuits 


to 
stot 


has been successtully transferred. In fact the complete WA/MEL 


Mailbox software and documentation was transferred in an ARC file 
between NEGE and WESEAd using FPMODEM on 144,76 in one connect ane 
Sunday afternoon. Many thanks ta WHé&EAd, NESE, WDOSAWP and NO&HaAk 
for helping me debug the pragram. 


i am interested in any feedback anyone may have. To am be reached 
Via the RLI HF systems @ WESEAT or ED6SQ or via landline at my 
ROP/M at (213) S41-25035. 


Yo 8 Skip WROYMH 
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PMODEM, DEC 6/22/86 


This implementation of Ymodem is written in ‘C’ with two assembly 
language modules. The ‘COC’ used was Microsoft (Lattice) Version 
1,044. Conversion to newer versions or other compilers should be 
straight forward, the primary differences expected being in the 
assembly language to ‘C’ interface. The modules are as follows: 


La FE MDOEM. G ~ Command line parser, calls SEND and RECEIVE. 
2. SEND.C ~ The sending side of the Ymodem protocol. 

S. RECEIVE.C - The receiving side of the Ymodem protocol. 
4. MODEM.H ~ Cammon equates to FMODEM.C, RECEIVE.C, and 


SEND, C 

“J. SERIAL.ASM ~ Serial support routines for PC’s COM1, polled 
for transmit, interrupt driven receive. 

Oe WILDEXFE.C = WE TL by Lear Zolman for expanding 
wildcard file specs. Converted from BDS-C on 
under Cr/M&@. 

7. SETFCR.ASM - Used by WILDEXF.C to setup MS-DOS fcb. 

8. PML. BAT ~ Batch file to compile and link all files to 
form FPMODEM. EXE 


9. PMODEM.EXE ~ Ready to run executable file, setup for COM1L 


This implementation of the YMODEM protocol implements all 
of the standard modes which are used on non-packet circuits as 
well as the ‘G° mode, as a result it is MUCH more complex than 
what i6 necessary for implementation of ‘GS’ mode anly. Currently 
the program anly supports the filename and file size fields of 
the batch header. The timestamps, file attributes and serial 
nunbers not sent and are ignored if received. 


Before using PMODEM to transfer files over packet . use your 
favorite terminal program, such as Crosstalk, to establish 
communications with the ather station, enter transparent mode and 
then exit your terminal program. FMODEM can now be run to either 
receive a file or transmit one. PMODEM will return to DOS when 
the transfer is completed, if a error is detected, or if Ctrl-X 
is hit on the keyboard. 


FMODEM does not initialize the baudrate of your serial port 
because it assumes that it has been initialized correctly prior 
to executing PMODEM. Both the TNC and FC should be configured far 
8 data bits, no parity and HARDWARE flow control. FPMODEM never 
asks the TNC ta stop sending data, but the TNC MUST be able toa 
tell the computer to stop sending data. Make sure the hardware 
flow control wired properly in your cable. (Fin. aogier so 
pin S on the TNCS). A good test of the hardware flow control is 
to begin a transfer and then turn off your radio. i+) -thea cer Low 
conteaL is correct the status readout from FPMODEM will stop 
advancing after several blocks. Tt the block number keeps 
increasing while your radia is turned off, your flow control is 
not working properly. 


Bath the TNC and the FPC’s COM port should be configured for 8 
data bits and no parity. Gn the TNC2 the correct settings are: 


FARITY = @ 
AWLEN = 8 
TRFLOW = of f 
TXELOW = of f 
XFLOW = aff 


If you are using a popular channel for binary file transfers it j 
is recommended that you also adjust DWAIT and FRACK to give other 
users priority on the channel to avoid monopolizing the channel 
with the transfer. 


After you have established a cannectian using your favorite 
communications program proceed as follows: 


“Ae CExit converse mode inta the TNC’s command maded. 
cmdit [Go inta transparent moded 
CTAt this point @xit you terminal program and return ta 
MS-DOS] 


If you are sending a files: 

Aspmadem sb test.bin 
H t——-—-> The file you wish ta send. 
tenner > Tells pmadem ta use BRatch mode 
fo a a ee > Tells pmodem to send a file 


If you are receiving a files 


Aspmadem rbq 


at 


tite---—-——> Tells pmodem to use ‘GG’ mode for Facket circuits 
Wier eae = Tells pmodem ta use Batch mode 
teen ene > Tae lis pmodem to receive one ar more files 


Another example, send all .DOC files and two executable files: 
Azpmadem sb *.doc test.com testl.gxe 


While not necessary it is always preferable ta use FMODEM in the 
batch mode even when transferring only one file. The correct file 
size will be recorded in the directory only if the file was 
transferred using batch mode, in nonbatch mode the file size 
will be rounded up to the next 128 byte boundary. This is not a 
problem with MOST files, but there are some programs which will 
malfunction if their data files are larger than expected. 


This program has been tested by five stations in the Los Angeles 
area over the last couple of months and several megabytes of data 
has been successfully transferred. In fact the complete WATMEL 
mailbox software and documentation was transferred in an ARC file 
between NESE and WEé6KEAI using FPMODEM on 144.74 in one connect one 
Sunday afternoon. Many thanks to WHéEAI, NESE, WOSAWP and N6HAE 
for helping me debug the program. 


TIT am interested in any feedback anyone may have. I am be reached 
via the RLI HF systems @ WEB6EAT or KD65Q or via landline at my 
RCP/M at (213) 541-2503. 


73'S Skip WR6YMH 


RIMEE Ae Setanta en vans | PES 
— PMODEM,. Dac 6/22/86 
This implementation of Ymodem is written in ‘C’ with two assembly 
fanguage modules. The ‘C’ used was Microsoft (Lattice) version 
1.04. Conversion to newer versions or other compilers should be 
Straight forward, the primary differences expected being in the 
assembly language to ‘C’ interface. The modules are as follows: 


er OD EM. Cc ~ Command line parser, calls SEND and RECEIVE. 

mee oe. C ~ The sending side of the Ymodem protocol. 

me RECEIVE.C - The receiving side of the Ymodem protocol. 

4. MODEM. H ~ Common equates to FPMODEM.C, RECEIVE.C, and 
SEND.C 


we SERTAL.ASM ~ Serial support routines for PC's COMI, polled 
for transmit, interrupt driven receive. — 
Meee eeEXP.C -— Utility by Leor Zzolman’ for expanding 
Wildcard file specs. Converted from BDS-C on 
. under Cr/M&a. 
7, SETFCR.ASM ~ Used by WILDEXF.C to setup MS-DOS fcb. 
8. FML. BAT ~ Batch file to compile and link all files to 
‘ee Paria MMOD EM sb AE ; 
“9. PMODEM.EXE ~- Ready to run executable file, setup for COMI 
This implementation of the YMODEM protocol implements ali 


Of the standard modes which are used on non-packet circuits a 
welt asthe ‘G° mode, as a result it is MUCH more complex than 
What 16 necessary for implementation of ‘G' mode only. Currently 
the program only supports the filename and file size fields of 
the batch header. The timestamps, file attributes and serial 
numbers not sent and are ignored if received. 


if 


Before Using PMODEM to transfer files over packet use your 
favorite terminal program, such as Crosstalk, to establish 
communications with the other etation, enter transparent mode and 
then exit your terminal program. FPMODEM can now be run to either 
receive a file or transmit one. FMODEM will return to DOS when 
the transfer is completed, if a error is detected, or if Ctr1l-x 
ig hit on the keyboard. 


PMODEM does not initialize the baudrate of your serial port 
‘“becatse it assumes that it has been initialized correctly prior 
tO executing PMODEM. Both the TNC and FC should be configured for 


8 data bits, no parity and HARDWARE flow control. FMODEM never 
asks the TNC to stop sending data, but the TNC MUST be able ta 
teil -the computer to stop sending data. Make sure the hardware 
flow control wired properly in your cable. (rei Teo ene ho ho 
Pee on the ™NC2). A good test of the hardware flow control is 
to begin a transfer and then turn of¢ your radia. Thecthe: flow 
control is cerrect the status readout from FMODEM will stop 
advancing after several biocks. Tf the block number keeps 
imcreasing while your radio is turned off, your flow control is 
not working properly. | 


Both the TNC and the PC's COM port should be configured for & 
data bits and no parity. Gn the TNCS the correct settings are: 


PARITY = @ 
AWLEN | 5 

— TRELOW ot ¢ 
TXFLOW of ¢ 

 XFLOW cat 


oe ee ae 


If YOU are using a popular channel for binary tile transfers it 
is recommended that vou also acdiust DWOALT and FRGCK to oive other 


